home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 / Ham Radio 2000.iso / ham2000 / bbs / makeinfo / makeinfo.doc < prev    next >
Text File  |  1994-03-04  |  6KB  |  167 lines
  1.  
  2.  
  3.                                 --  MAKEINFO  --
  4.  
  5.                                   version  1.0
  6.  
  7.                                        by
  8.  
  9.                                      OZ4ABL
  10.                              Jesper "Jones" Hansen
  11.  
  12.  
  13.  
  14.  
  15. Disclaimer:
  16. -----------
  17. This program (and it's source) is destributed as blæse-ware, which means
  18. that i don't care what you do with it. You man change my name and claim
  19. that you have codet it, i won't care a bit because i codet it for my own
  20. use, but i have mailed it because there are maybe other OM's (and YL's)
  21. that can use this program.
  22. I can't in any way be responsible in any way if this program blows of you'r
  23. house, you'r dog dies of cancer two days after you got this program, or
  24. your computer melts right down through you house.
  25. But if such a thing should happend i will be werry glad to hear about it.
  26.  
  27.  
  28. Description:
  29. ------------
  30. MAKEINFO is a program to automaticly make the REGISTER.DIR files in all
  31. dirs. The REGISTER.DIR will look like this:
  32.  
  33. Catalog of C:\HAM\VIRUS
  34. VSCAN.EXE       12994  01-02-94  21:33 A virus scanner
  35. OZ1XXX.TLX      12863  20-02-94  23:52 Look out for new virus
  36. OZ6XXX.TLX       2333  22-02-94  12:17 RE: Look out for new virus
  37.  
  38. First there is the name of the file, then the size, the date in DAY-MONTH-
  39. YEAR notation, and then the time. The name, data and time are the orginaly
  40. from the disk, but the description at the end can come from diffrent
  41. sources:
  42. 1) You can type it with an editor when you have created the REGISTER.DIR
  43.    files with MAKEINFO.
  44. 2) MAKEINFO will automaticly try to open the file called DESCRIPT.ION (used
  45.    by NDOS and 4DOS for file descriptions) and snatch the describtion from
  46.    there.
  47. 3) If the program can't find any matches in REGISTER.DIR and DESCRIPT.ION
  48.    it will open the file and read the ten first lines. If any of there lines
  49.    contain the text SUBJECT:, TITEL: or INFO: as the first word, the rest
  50.    or the line will be used as description. An example:
  51.    You have down-loaded the file TNC3.TXT witch contains:
  52.  
  53.    [58342] B   BID: 0743DB0AABZF
  54.    Path: OZ5BBS!OZ5BBS!OZ8BBS!OZ3BOX!OZ2BOF!OZ7BOX!OZ6BOX!DB0HES!DB0OQ!DB0HBS
  55.    Path: DB0CL!DB0CEL!DK0MNL!DB0DNI!DB0ERF!DB0EAM!DB0GV!DK0MTV!DB0RBS!DB0AAA
  56.    Path: DB0MWE!DB0AAB
  57.    Date: 08 Apr 93 06:18:02 Z
  58.    From: DG8GAD @ DB0AAB.#BAY.DEU.EU
  59.    To: TNC@WW
  60.    Subject: TNC3 Concept and System Description
  61.    ...
  62.    ...
  63.    ...
  64.    ** [End Msg # 58342]
  65.  
  66.    When you run MAKEINFO it will automaticly find the SUBJECT: line and
  67.    then add the following line to REGISTER.DIR:
  68.  
  69.    TNC3.TXX        15386  22-02-94  12:17 TNC3 Concept and System Description
  70.  
  71.  
  72. You can also make MAKEINFO update 4DOS's DESCRIPT.ION files, so they match
  73. REGISTER.DIR. This is done with the -u switch.
  74.  
  75. When the directories are scanned the descriptions in REGISTER.DIR and
  76. DESCRIPT.ION are compared, and if they don't match you will be asked witch
  77. of them you will use.
  78.  
  79.  
  80. Usage:
  81. ------
  82. Usage: MAKEINFO [-hru] [Seekword1] [Seekword2] .. [Seekword6]
  83.                 -h       = This help text
  84.                 -r       = Recurse subdirectories
  85.                 -u       = Make/update 4DOS/NDOS's description files
  86.                 seekword = Alternative telex seek-word.
  87. where:
  88. -h       = Will show a little help.
  89. -r       = All sub-directories will also be processed
  90. -u       = The 4DOS/NDOS description files will also be updated
  91. seekword = There will also be checked for this text in files (case insensitive).
  92.  
  93. The t option:
  94. If you live outside England/Denmark you will most likely not have a
  95. SUBJECT line in you're telexes. So if MAKEINFO must recognice you're headers
  96. you will have to use the -T option. An example: You're local mailbox uses the
  97. word TITLE to describe the telexes:
  98.  
  99.     From     : XX1ZZZ @ XX1YYY
  100.     To       : ALL@WW
  101.     Title    : CQ CQ CQ WORLD
  102.          ^^^^
  103.  
  104. You will then have to start MAKEINFO like this:
  105.  
  106.     MAKEINFO "title    :"
  107.                    ^^^^ These MUST match the number og spaces in the telexe's
  108.  
  109. The spaces are werry important, if you get these wrong the program can't
  110. find the title of the file. The quotes are also werry important because the
  111. title includes spaces.
  112.  
  113. If you'r files looked like this:
  114.  
  115.     From: ZZ2YYY @ ZZ1QQQ
  116.     To: DX@WW
  117.     Info: HELLO WORLD.
  118.  
  119. You will type:
  120.  
  121.     MAKEINFO info:
  122.  
  123. This time you don't need the quotes because there are no spaces in the text.
  124.  
  125. You can also search for more than one text at a time:
  126.  
  127.     MAKEINFO info: "title    :"
  128.  
  129. But max six at a time.
  130.  
  131.  
  132. Important things:
  133. -----------------
  134. The descriptions can be upto 256 characters long, but 4DOS prior to version
  135. 5.0 can only handle 40 characters.
  136. If you already have some REGISTER.DIR files on you'r harddisk you will get
  137. some errors, and the program will terminate. This is because it can't 
  138. recognice the files as it's own format and will think they are corrupted!
  139.  
  140.  
  141. Known bugs:
  142. -----------
  143. ????
  144.  
  145.  
  146. Unknown bugs?
  147. -------------
  148. If you use this program and find some bugs i will be glad to hear from you.
  149.  
  150.  
  151. Last words:
  152. ----------
  153. This program was made of one reasons:
  154. 1) I already had a program that could make the REGISTER.DIR files, but it
  155.    couldn't recognise TITLE, and INFO. And it did not use/update the
  156.    DESCRIPT.ION files.
  157. All spelling-errors are (C) Copyrighted by me and may not be changed!
  158.  
  159.  
  160.  
  161. +---------------------------------+---------------------------------+
  162. | There are no such thing as bugs | Vy 73 de OZ4ABL - Jesper Hansen |
  163. |   only unrecognizes features!   |  "Jones/Funky Buddhas/Rednex"   |
  164. +---------------------------------+---------------------------------+
  165. |      --==>>      OZ4ABL @ OZ6BOX.kru.jys.dnk.eu.      <<==--      |
  166. +-------------------------------------------------------------------+
  167.